...and couldn't find anywhere, you will find in this Elektor art- 
cle (and where else would you find it?). It’s a natural idea to 
use a PC keyboard for developing microcomputer applica- 
tions, for example, in order to send commands or respond to 
specific actions. Why go to the trouble of building your own 
keyboard when you can use a ready-made (and inexpen- 
sive) PC keyboard? The only problem is that you first have to 
know exactly what signals a PC keyboard supplies. 


By E Wo hlta be 


PCkeyboard encoding 


Everything you ever wanted to know about 
the signals from a PC keyboard... 





In addition to the ready a valla bility, low 
costand accustomed manner of use 
of a PC keyboard, connecting a PC 
keyboard directly to a microcontroller 
system has the advantage that it 
makes valuable port pins available that 
otherwise would be used for polling a 
keyboard built from individual compo- 
nents. APC keyboard, by contrast, pro- 
duces a senal signal, and is thus an 
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ideal complement to a microcontroller 
project. Of course, the manner in which 
the signal from the PC keyboard is con- 
structed has a few special features. 
Two lines are used for the senal data 
transfer. One of these, labelled data, 
transfers the data, while the second 
one transfers the clock. The serial data 
transfer protocol, which is fairly com- 
plex, is explained below. 


Key codes 

The most widely-used type of keyboard 
is the MF2 model (‘multi-functional ver- 
sion 2’). It was originally developed by 
IBM for computers in the XT, ATand PS/2 
series. This model has become an 
industry standard in the meantime, and 
almost all PCs are equipped with it. The 
keyboard itself contains a ‘keyboard 
controller’, which generates the key 
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codesand provides for communication 
with the keyboard interface of the PC. 
The keyboard controller is usually a 
mask-programmed microcontroller. 
Data are sentand received according 
to the IBM protocol. Commands can 
be used to control the LEDs, specify the 
delay and rate for key repetition, and 
select the scan code set. The MF2 key- 
board has three different scan code 
sets. Set 1 is used by XT/PC and PS/2-30 
compatible computers, while set 2 is 
used by AT computers and all other 
PS/2-compatible computers. Set 3 sup- 
ports workstations and terminal emula- 
tion on the PC. Country-specific key- 
board drivers in the operating system 
translate each key press into the 
desired character. 

When a key is pressed, the keyboard 
producesa Make code. This code cor- 
responds to the scan code for that key. 
The repeat function causes the Make 
code to be continuously repeated if 
the key is held down long enough. The 
delay time and repetition rate of the 
repeat function are programmable. 
When a key is released, the keyboard 
produces a Break code. However, if 
scan code set 3 is selected, no Break 
code is generated and the repeat 
function is disabled. After a reset, the 
keyboard selects scan code set2 asa 
defa ult. 


You should bearin mind that a PC/XT 
keyboard cannot be programmed, 
since its intemal controller cannot 
accept data. Only with the introduction 
of the AT computer did the keyboard 
become more user-friendly, since the 
behaviour of an AT keyboard can be 
adapted to the needs of the user via 
software. The following information 
relates to a keyboard that is set to oper- 
ate in the ATmode. 


Sending and receiving 


Figure 1 shows the pin assignments of 
the two commonly-used keyboard 
plugs (the 5-pin DIN plug and the 6-pin 
PS/2 plug). The keyboard is powered 
with 5 V from the PC. Its maximum cur- 
rent consumption is around 200 mA. 

In general, the clock rate is set by the 
keyboard. It lies in the range of 10 to 
16.7 kHz. Data are sent using a start bit 
(always 0), eight data bits with bit O first, 
an odd-panty bitand a stop bit (always 
1). Figure 2 shows the data transfer tim- 
ing diagram. 

If an external device or system (which 
is nomally a PC) wants to send data to 
the keyboard, the keyboard recognizes 
this by the fact that the data line is 
pulled to earth by the extemal device 
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Figure 1. Pin assignments of the standard PC keyboard connectors (viewed from the front). 


(the PC). The keyboard responds by 
sending the clock signal, and it expects 
the data to be sent synchronized to the 
clock signal. After the data transfer, the 
data line must exhibit a High level, 
which acts as the stop bit. The key- 
board will continue to send the clock 
until this condition is satisfied. Following 
this, the command FE, is sent to request 
a new data packet. Data are 
accepted on the rising edge of the 
clock signal. After the stop bithas been 
detected, the keyboard controller 
holds the data line Low forthe duration 
of one bit period. The keyboard 
answers every command that it 
receives, within at most 20 ms, by send- 
ing the byte FA, (ACK), except for the 
ECHO and RESET commands. 

The keyboard sends data in the AT for- 
mat to an extemal device using the fol- 
lowing process. 

Before sending data, the keyboard 
controller first tests whether the clock or 


data line is at earth level. Communi- 
cations can be blocked by holding the 
Clock line Low. In this case, the key- 
board holds the data to be sent in an 
intemal buffer. The keyboard can send 
data only if both the clock and data 
lines are ata High level. It then sets the 
data line Low (for the start bit) and 
generates the clock signal. The data 
are valid on the falling edge of the 
clock signal and change after the ris- 
ing edge. 


In orderto implementa MF2 keyboard 
connection in a microcomputer sys- 
tem, you will also need to know certain 
information regarding the most impor- 
tant commands and retum codes for 
an ATkeyboard. These are descnbed in 
the following section. The key codes, 
which are the codes that the keyboard 
produces according to the selected 
scan-code set when keys are pressed, 
are listed in Table 1. 


keyboard clock la] l2] la] la] Ls | le] |7| Ls | Lo | lio] lu] 





keyboard data 





external data 


| a a a 


keyboard pulling low NS 
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Figure 2. Timing diagram for seral data transfers between the keyboard and a PC. 


The most important commands 


SET/RESET MODE INDICATORS > code ED, 
This two-byte command controls the behaviour of the LEDs. 


Command: EDy 
Command: 0000 Oxxx 
Bit 0: Scroll loc k 
Bit 1: Num lock 
Bit 2: Caps lock 
1 = LED on, O = LED off 
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ECHO > code EE, 
The keyboard answers this command with EEy. It can be 
used to confirm the presence ofa keyboard. 


SC AN CODES SELECT > code FO, 

This two-byte command selects the scan code set. Scan 
code set 2 is selected by default after a reset. However, 
scan code set 3 recommends itself for microcontroller 
applications, due to its simplicity. With scan code set 3, no 
Break code is sent for almost all keys and the repeat func- 
tion is disabled. 

Command: FO y 

Command: 0000 00xx 

01 = scan code set 1 

10 = scan code set 2 

11 = scan code set 3 


READING ID CODE > code F2y 

In response to this command, the keyboard sends three 
bytes which contain a manufacturerspecific code. 

1st byte = FAy (AC K) 

2nd byte = xxxx XXXX 

3rd byte = XXXX XXXX 


SET TYPEMATIC RATE/DELAY -> code F3 y 

This two-byte command controls the key repeat rate and 
the delay for starting key repetition. 

Command: F3y 

Command: Oxxx xxxx 

Bits 5 and 6 control the delay, which ranges from 150 ms to 
ies: 


Bit 6 Bit 5 Delay (+ 20%) 
0 0 150 ms 

0 1 500 ms 

1 0 750 ms 

1 1 1s 


Bits 0 through 4 control the repetition rate, which ranges 
from 2 to 30 Hz. In the following table, only three values are 
shown as examples. 

Bt4 Bt3 Bt2 Btl BtO Frequency (+ 20%) 

0 0 0 0 0 30 Hz 

0 1 1 1 1 8 Hz 

1 1 1 1 1 2 Hz 


SET ALL KEYS > codes F7 y, F8y, F9y, FAy 

These commands assign attributes to the keys, as follows: 
e F7y: all keys have the repeat function 

e F8y: all keys produce Make and Break codes 

e F94: all keys produce only a Make code 

e FAy: all keys have the repeat function and produce 
Make and Break codes 


RESET > code FFy 
This command restores all keyboard settings to their defa ult 
values. 


The most important retum codes 


BAT COMPLETION > code AA, 

This byte is sentto the extemal system afterthe supply volt- 
age hasbeen applied ora reset command (FF) has been 
recognized. In indicates correct execution of the keyboard 
self-test. 


RESEND NAK > code FE 
This byte is sent in response to a data transfer error. 


ACK > code FA, 
This byte is sent to the extemal device in response to each 
received command. 


OVERRUN > code 00y/FFy 

All key presses are stored internally in the keyboard until 
their codes can be serially transferred to the extemal 
device. If the storage buffer overflows, the byte 00y is sent 
for scan code sets 2 and 3, while the byte FF, is sent for 
scan code set 1. 


BREAK CODE PREFIX > code FO, 
With scan code set 2, the byte FOy is sent before the Break 
code, 


Progra mming example 

In conclusion, the manner in which a 
(microcontroller) system should address 
an ATkeyboard can be illustrated with 
a simple programming example. 
When the 5-V supply voltage is 
switched on, +5 Visapplied to the key- 
board. The keyboard controller in the 
keyboard then executes a self-test. If 
this is Completed successfully, the key- 
board sends the byte AA. 


Next comes the selection of the scan 
code set. In this example, scan code 
set 3 is selected using the SCAN CODES 
SELECT command, as follows: 
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1 Pull the data line to earth. 

2 Send the command code FO,, syn- 
chronous to the clock. 

3 The keyboard sends the code FAy 
(ACK) as confirmation. 

4 Pull the data line to earth. 

5 Send the command code 03, syn- 
chronous to the clock. 

6 The keyboard sends the code FAy 
(ACK) as confirmation. 


Now a key can be pressed, and the 
key code from the scan code 3 set 
(see Table 1) will be received: 


7 Press 'G' on the keyboard. 


8 The keyboard sends the code 34. 
A practical application example of the 
use ofa PC keyboard with a microcon- 
troller system is “Text Running Line Dis- 
play” elsewhere in this Supplement. In 
this example, a common or vanety PC 
keyboard is used for entering text to be 
displayed on an LED running-line dis- 
play. Keyboard decoding is handled 
by a COP-8 microcontroller and the 
data transferto the running-line displa y 
uses an infrared link. The photo at the 
head of this article shows a small circuit 
board holding the keyboard decoder 
and IR transmitter. 

(002008-1) 
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Table 1. 
The key codes produced when keys are pressed, for each of the three scan code sets. 
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B = Break code when key released 
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